vdoing FAQ
问答
我为什么要从docusaurus迁移到vdoing
1、docusaurus首页没标签/分类/站点信息等特性
docusaurus首页：
vdoing首页：
2、docusaurus原作者不再更新项目了🤣
3、vue生态很不错，但docusaurus生态不咋的
4、vdoing的确不错哇，知识库+博客
最后：迁移docus数据到vdoing
docus数据
这个是在坚果云里已经同步了的，且是docus站内内容：
为了不损坏原来docus网站数据，这里把关键md拷贝一份到百度云同步空间里：然后从这个目录里迁移数据就行（以后禁止更新老目录里的内容）
我是一个小白，想使用这个主题搭建博客（知识库）需要做哪些工作？
答：使用这个主题前需要你掌握下面这些知识：
- 掌握 markdown (opens new window)、yaml (opens new window)语法
- 会使用终端（命令行），会使用 git
- 会阅读文档、搜索文档
- 会VuePress (opens new window)的基本使用和默认主题的基本配置
以上知识都掌握之后，再查看本文档。你也可以运行我的主题项目，一边看代码，一边查看文档。主题项目内写了比较多的注释代码，方便你的学习和使用。
clone 项目后需要修改哪些地方？
答：大致的修改流程是这样的：
- 首先让项目正常的跑起来
- 根据需求构建和替换
[docs/<结构化目录>](https://doc.xugaoyi.com/pages/2f674a/)的目录及内容 - 根据需求修改 config.js 配置
- 修改 首页配置
- 修改 主题颜色和样式（如果你想修改的话）
可减少项目冗余的地方有哪些？
答：在完成项目的搭建之后，对于没有使用到的一些文件和代码，可以看情况删减，可删减的地方有:
- 卸载
config.js中未使用的插件依赖包 - 参照 目录结构，删除未使用到的
可选文件 - 删除
.vusepress目录内未使用到的可选文件 - 删除各文件内的注释代码
我可以不使用永久链接吗？
答：不可以。当你没有在front matter指定永久链接时，主题会自动生成永久链接到front matter，你可以修改永久链接的值。 使用永久链接是出于以下几点考虑:
- 在
config.js配置nav时使用永久链接，就不会因为文件的路径或名称的改变而改变。 - 对于博客而言，当别人收藏了你的文章，在未来的时间里都可以通过永久链接来访问到。
- 主题中的
目录页需要通过永久链接来访问文章。
是否支持国际化？
答：暂不支持。目前的国际化方案，只能是使用不同项目来处理，比如：一个项目是中文，一个项目是英文，在导航中添加中英文站点的链接。
打包后在本地预览怎么没有样式？
答：因vuepress打包后的CSS、JS等资源链接采用绝对路径引入，在本地预览时的引入链接是不正确的，部署到服务器即可正常引入和预览。如果你确实需要本地预览，可以使用vuepress-plugin-serve (opens new window)插件，使用方法看相应文档。
在build时出现错误，但是在dev时是正常的
答：这种情况多半是因为你在created或beforeCreate生命周期调用了浏览器API的原因导致，详情查看：[浏览器的 API 访问限制](
什么情况下，我才需要升级呢？
2024年12月24日提出问题。
问题：什么情况下，我才需要升级呢？
升级后，是否会影响我现在项目的正常运行呢？？？😜
cdn问题（已闭环）
环境
2024年12月23日测试
基于官方https://github.com/xugaoyi/vuepress-theme-vdoing搭建的仓库。
故障现象
讨论过程
待进一步测试
我的域名是配置了cdn的
当前自己web状态如下
这里是空的
开始推送数据到云服务器
推送完成
2024年12月24日12:48:51
待观察效果
清空浏览器缓存：
再次验证：（web没出现新内容）
这里等待数个小时，再次观察下效果
这里刷新下网页，新的内容就会更新出来的。那就是没问题的哈哈。😜😜😜
结论
已闭环。没啥问题的，我们正常使用cdn加速域名，正常更新内容就好。😜😜😜
2024年12月24日
我更换了目录后，那么该文档的分类是不会自动改变的哇？（待解决）
2024年12月24日
我更换了目录后，那么该文档的分类是不会自动改变的哇？
该怎么办呢？？？（手动该，太麻烦了。。。）
咋不用 vitepress 嘞
有同学问了，你咋不用 vitepress 嘞？
啊，也用过，但是在生态和成熟度上不及 VuePress，折腾一番后还是选择返璞归真。
--来源于《鱼皮》